RapidSpell Desktop .NET Documentation: 3rd Party Control Support

3rd Party Control Support

3rd party control support is offered through support DLLs, support class source code and knowledge base articles (http://keyoti.com/kb), as appropriate. The Visual Studio demos accompanying this product demonstrate support with a selection of controls - please consult the demos folder for what is currently available.

TX Text Control 16 and higher

To use RapidSpell with TX Text Control it is necessary to reference Keyoti.RapidSpell.NET2.TXSupportv1X.DLL instead of Keyoti.RapidSpell.NET2.DLL. It is important to choose the correct version of Keyoti.RapidSpell.NET2.TXSupportv1X.DLL as it references a particular version of TX TextControl.

Do NOT use RapidSpellAsYouType (as-you-type checking is now handled by RapidSpellDialog) or the TXTextControlAdapter classes. Use only RapidSpellDialog and it's AddTextComponent to assign a TextControl to be spell checked (dialog and as you type).

Basic Setup

Open/create a project which uses TX Text Control
Open the form holding TX Text Control, and drag on RapidSpellDialog.
Configure the "Text Control" property in RapidSpellDialog.
Add a button or menu item and start RapidSpellDialog in it's click handler, calling RapidSpellDialog.Check()

At this stage the spell check should work, however a few changes are needed for optimal integration.

ContextMenuStrip

RapidSpellDialog will need to control the ContextMenuStrip for the Text Control. Therefore, unset the TextControl.ContextMenuStrip property in the designer, to null/Nothing/none. Then set RapidSpellDialog's ContextMenuStripDefault property to the ContextMenuStrip to use when the user clicks away from a spelling error.

In the regular TX Text Control examples, there is a MouseDown event handler, which is used to show the regular 'text context menu'. This should be commented out, so that the context menu strip is not manually shown on the MouseDown event - RapidSpell will take care of this.

In the regular TX Text Control examples, there is a TextFrameRightClicked event handler, which shows the context menu for textframes when the user right clicks on a frame edge. Modify textControl1_TextFrameRightClicked, by adding

//C#
if (rapidSpellDialog1.GetSuggestionsToolStripItems() == null)
{
...
}

'VB.NET
If RapidSpellDialog1.GetSuggestionsToolStripItems() Is Nothing Then
...
End If

around it's contents, so that the menu logic isn't performed when there are spelling suggestions.

Resetting Ignored Words (When Creating/Opening New Documents)

To reset the words that have been ignored for a document, call

rapidSpellDialog1.ResetIgnoredWords()

TX Text Control 15.1 and lower

For a detailed how to, please see http://keyoti.com/kb/Default.aspx?ToDo=view&questId=97&catId=44 or the demos under the TX TextControl subfolder inside the Examples folder.

DevExpress XtraGrid, MemoEdit, MemoExEdit, TextEdit

Support for DevExpress controls is provided through the class RapidSpell_DevExpressAdapter_Glue which is supplied in source code form with the DevExpress Visual Studio demo projects. This class includes (in the case of the text editors) subclasses of the DevExpress controls which can be used in place. This class also includes column editor repository classes for grid spell checking. The demo projects and 'Use Case' section show usage. Support for DevExpress is version agnostic, which means it is safe to upgrade regularly without needing updates for RapidSpell support.

Janus GridEX, EditBox

Support for Janus controls is provided through subclasses of Janus control classes for the text editors and through grid events. The demo projects and 'Use Case' section show usage. Support for is version agnostic, which means it is safe to upgrade regularly without needing updates for RapidSpell support.

Infragistics

Support DLLs for certain versions are provided, these enable use of RapidSpell with Infragistics' UltraTextEditor and UltraGrid. These are provided for legacy users - please email support@keyoti.com if help is needed with these controls.